Direct Profile Upload API

The Direct Profile Upload API provides synchronous upload of profiles directly in the request body.

API Endpoint

POST /api/v3/profile-upload/contacts

Headers

Header	Value	Required
`x-api-key`	`{{api_key}}`	Yes
`Content-Type`	`application/json`	Yes

Request Syntax

POST /api/v3/profile-upload/contacts
x-api-key: {{api_key}}
Content-Type: application/json

{
  "profile": [
    {
      "phone": "917415908509",
      "countrycode": "IN",
      "name": "Aarav Sharma",
      "age": 29,
      "gender": "male",
      "dob": "27/03/2000",
      "businesssubscriberid": "CUST-98712",
      "city": "Mumbai"
    }
  ]
}

The specification's sample uses a Unix-epoch integer for dob, while its field description specifies DD/MM/YYYY. Confirm the accepted format with Msgkart before sending dob.

Response Syntax

200 OK Response (Success)

{
  "status": "success",
  "total": 1,
  "uploaded": 1,
  "rejected": 0
}

Response Fields

Field	Type	Description
`status`	`string`	Execution result (for example, `"success"`).
`total`	`integer`	Total number of records submitted in the call.
`uploaded`	`integer`	Number of successfully processed/upserted profiles.
`rejected`	`integer`	Number of rejected records due to invalid data (e.g., invalid phone format).

Run in Postman

API Endpoint​

Headers​

Request Syntax​

Response Syntax​

200 OK Response (Success)​

Response Fields​